home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 November / SGI Freeware 1999 November - Disc 2.iso / dist / fw_IZzip.idb / usr / freeware / catman / u_man / cat1 / zip.z / zip
Text File  |  1997-09-09  |  37KB  |  793 lines

  1.  
  2.  
  3.  
  4.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           zip, zipcloak, zipnote, zipsplit - package and compress
  10.           (archive) files
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           zzzziiiipppp [----ccccddddDDDDeeeeEEEEffffFFFFgggghhhhjjjjkkkkllllLLLLmmmmooooqqqqrrrrSSSSTTTTuuuuvvvvVVVVwwwwyyyyzzzz@@@@$$$$] [----bbbb ppppaaaatttthhhh] [----nnnn ssssuuuuffffffffiiiixxxxeeeessss]
  14.           [----tttt mmmmmmmmddddddddyyyyyyyy] [ _z_i_p_f_i_l_e [ _f_i_l_e_1 _f_i_l_e_2 ...]]  [----xxxxiiii lllliiiisssstttt]
  15.  
  16.           zzzziiiippppccccllllooooaaaakkkk [----ddddhhhhLLLL] [----bbbb ppppaaaatttthhhh] _z_i_p_f_i_l_e
  17.  
  18.           zzzziiiippppnnnnooootttteeee [----hhhhwwwwLLLL] [----bbbb ppppaaaatttthhhh] _z_i_p_f_i_l_e
  19.  
  20.           zzzziiiippppsssspppplllliiiitttt [----hhhhiiiiLLLLppppsssstttt] [----nnnn ssssiiiizzzzeeee] [----bbbb ppppaaaatttthhhh] _z_i_p_f_i_l_e
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           _z_i_p is a compression and file packaging utility for Unix,
  24.           VMS, MSDOS, OS/2, Windows NT, Minix, Atari and Macintosh.
  25.           It is analogous to a combination of the UNIX commands _t_a_r(1)
  26.           and _c_o_m_p_r_e_s_s(1) and is compatible with PKZIP (Phil Katz's
  27.           ZIP for MSDOS systems).
  28.  
  29.           A companion program (_u_n_z_i_p(1L)), unpacks _z_i_p archives.  The
  30.           _z_i_p and _u_n_z_i_p(1L) programs can work with archives produced
  31.           by PKZIP, and PKZIP and PKUNZIP can work with archives
  32.           produced by _z_i_p.  _z_i_p version 2.0.1 is compatible with PKZIP
  33.           2.04 Note that PKUNZIP 1.10 cannot extract files produced by
  34.           PKZIP 2.04 or _z_i_p 2.0.1. You must use PKUNZIP 2.04g or _u_n_z_i_p
  35.           5.0p1 (or later versions) to extract them.
  36.  
  37.           For a brief help on _z_i_p and _u_n_z_i_p, run each without
  38.           specifying any parameters on the command line.
  39.  
  40.           The program is useful for packaging a set of files for
  41.           distribution; for archiving files; and for saving disk space
  42.           by temporarily compressing unused files or directories.
  43.  
  44.           The _z_i_p program puts one or more compressed files into a
  45.           single _z_i_p archive, along with information about the files
  46.           (name, path, date, time of last modification, protection,
  47.           and check information to verify file integrity).  An entire
  48.           directory structure can be packed into a _z_i_p archive with a
  49.           single command.  Compression ratios of 2:1 to 3:1 are common
  50.           for text files.  _z_i_p has one compression method (deflation)
  51.           and can also store files without compression.  _z_i_p
  52.           automatically chooses the better of the two for each file to
  53.           be compressed.
  54.  
  55.           When given the name of an existing _z_i_p archive, _z_i_p will
  56.           replace identically named entries in the _z_i_p archive or add
  57.           entries for new names.  For example, if _f_o_o._z_i_p exists and
  58.           contains _f_o_o/_f_i_l_e_1 and _f_o_o/_f_i_l_e_2, and the directory _f_o_o
  59.           contains the files _f_o_o/_f_i_l_e_1 and _f_o_o/_f_i_l_e_3, then:
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 12/9/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  71.  
  72.  
  73.  
  74.                zip -r foo foo
  75.  
  76.           will replace _f_o_o/_f_i_l_e_1 in _f_o_o._z_i_p and add _f_o_o/_f_i_l_e_3 to
  77.           _f_o_o._z_i_p.  After this, _f_o_o._z_i_p contains _f_o_o/_f_i_l_e_1, _f_o_o/_f_i_l_e_2,
  78.           and _f_o_o/_f_i_l_e_3, with _f_o_o/_f_i_l_e_2 unchanged from before.
  79.  
  80.           If the file list is specified as ----@@@@, _z_i_p takes the list of
  81.           input files from standard input.  Under UNIX, this option
  82.           can be used to powerful effect in conjunction with the
  83.           _f_i_n_d(1) command.  For example, to archive all the C source
  84.           files in the current directory and its subdirectories:
  85.  
  86.                find . -name "*.[ch]" -print | zip source -@
  87.  
  88.           (note that the pattern must be quoted to keep the shell from
  89.           expanding it).  _z_i_p will also accept a single dash ("-") as
  90.           the zip file name, in which case it will write the zip file
  91.           to standard output, allowing the output to be piped to
  92.           another program. For example:
  93.  
  94.                zip -r - . | dd of=/dev/nrst0 obs=16k
  95.  
  96.           would write the zip output directly to a tape with the
  97.           specified block size for the purpose of backing up the
  98.           current directory.
  99.  
  100.           _z_i_p also accepts a single dash ("-") as the name of a file
  101.           to be compressed, in which case it will read the file from
  102.           standard input, allowing zip to take input from another
  103.           program. For example:
  104.  
  105.                tar cf - . | zip backup -
  106.  
  107.           would compress the output of the tar command for the purpose
  108.           of backing up the current directory. This generally produces
  109.           better compression than the previous example using the -r
  110.           option, because _z_i_p can take advantage of redundancy between
  111.           files. The backup can be restored using the command
  112.  
  113.                unzip -p backup | tar xf -
  114.  
  115.           When no zip file name is given and stdout is not a terminal,
  116.           _z_i_p acts as a filter, compressing standard input to standard
  117.           output.  For example,
  118.  
  119.                tar cf - . | zip | dd of=/dev/nrst0 obs=16k
  120.  
  121.           is equivalent to
  122.  
  123.                tar cf - . | zip - - | dd of=/dev/nrst0 obs=16k
  124.  
  125.           _z_i_p archives created in this manner can be extracted with
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 12/9/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  137.  
  138.  
  139.  
  140.           the program _f_u_n_z_i_p which is provided in the _u_n_z_i_p package,
  141.           or by _g_u_n_z_i_p which is provided in the _g_z_i_p package. For
  142.           example:
  143.  
  144.           dd if=/dev/nrst0  ibs=16k | funzip | tar xvf -
  145.  
  146.           When changing an existing _z_i_p archive, _z_i_p will write a
  147.           temporary file with the new contents, and only replace the
  148.           old one when the process of creating the new version has
  149.           been completed without error.
  150.  
  151.           If the name of the _z_i_p archive does not contain an
  152.           extension, the extension ._z_i_p is added. If the name already
  153.           contains an extension other than ._z_i_p the existing extension
  154.           is kept unchanged.
  155.  
  156.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  157.           ----bbbb ppppaaaatttthhhh
  158.                Use the specified _p_a_t_h for the temporary _z_i_p archive.
  159.                For example:
  160.  
  161.                     zip -b /tmp stuff *
  162.  
  163.                will put the temporary _z_i_p archive in the directory
  164.                /_t_m_p, copying over _s_t_u_f_f._z_i_p to the current directory
  165.                when done. This option is only useful when updating an
  166.                existing archive, and the file system containing this
  167.                old archive does not have enough space to hold both old
  168.                and new archive at the same time.
  169.  
  170.           ----cccc   Add one-line comments for each file.  File operations
  171.                (adding, updating) are done first, and the user is then
  172.                prompted for a one-line comment for each file.  Enter
  173.                the comment followed by return, or just return for no
  174.                comment.
  175.  
  176.           ----dddd   Remove (delete) entries from a _z_i_p archive.  For
  177.                example:
  178.  
  179.                     zip -d foo foo/tom/junk foo/harry/\* \*.o
  180.  
  181.                will remove the entry _f_o_o/_t_o_m/_j_u_n_k, all of the files
  182.                that start with _f_o_o/_h_a_r_r_y/, and all of the files that
  183.                end with ._o (in any path).  Note that shell pathname
  184.                expansion has been inhibited with backslashes, so that
  185.                _z_i_p can see the asterisks, enabling _z_i_p to match on the
  186.                contents of the _z_i_p archive instead of the contents of
  187.                the current directory.
  188.  
  189.                Under MSDOS, ----dddd is case sensitive when it matches names
  190.                in the _z_i_p archive.  This requires that file names be
  191.                entered in upper case if they were zipped by PKZIP on
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 12/9/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  203.  
  204.  
  205.  
  206.                an MSDOS system.
  207.  
  208.           ----DDDD   Do not create entries in the _z_i_p archive for
  209.                directories.  Directory entries are created by default
  210.                so that their attributes can be saved in the zip
  211.                archive.  The environment variable ZIPOPT can be used
  212.                to change the default options. For example under Unix
  213.                with sh:
  214.  
  215.                     ZIPOPT="-D"; export ZIPOPT
  216.  
  217.                (The variable ZIPOPT can be used for any option except
  218.                ----iiii and ----xxxx and can include several options.) The option
  219.                ----DDDD is a shorthand for ----xxxx "*/" but the latter cannot be
  220.                set as default in the ZIPOPT environment variable.
  221.  
  222.           ----eeee   Encrypt the contents of the _z_i_p archive using a
  223.                password which is entered on the terminal in response
  224.                to a prompt (this will not be echoed; if standard error
  225.                is not a tty, _z_i_p will exit with an error).
  226.  
  227.           ----eeeeeeee  Encrypt contents, prompting for the password _t_w_i_c_e,
  228.                checking that the two entries are identical before
  229.                using the password.
  230.  
  231.           ----ffff   Replace (freshen) an existing entry in the _z_i_p archive
  232.                only if it has been modified more recently than the
  233.                version already in the _z_i_p archive; unlike the update
  234.                option (----uuuu) this will not add files that are not
  235.                already in the _z_i_p archive.  For example:
  236.  
  237.                     zip -f foo
  238.  
  239.                This command should be run from the same directory from
  240.                which the original _z_i_p command was run, since paths
  241.                stored in _z_i_p archives are always relative.
  242.  
  243.           ----FFFF   Fix the _z_i_p archive. This option can be used if some
  244.                portions of the archive are missing. It is not
  245.                guaranteed to work, so you MUST make a backup of the
  246.                original archive first.
  247.  
  248.                When doubled as in ----FFFFFFFF the compressed sizes given
  249.                inside the damaged archive are not trusted and zip
  250.                scans for special signatures to identify the limits
  251.                between the archive members. The single ----FFFF is more
  252.                reliable if the archive is not too much damaged, for
  253.                example if it has only been truncated, so try this
  254.                option first.
  255.  
  256.                Neither option will recover archives that have been
  257.                incorrectly transferred in ascii mode instead of
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 12/9/95)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  269.  
  270.  
  271.  
  272.                binary. After the repair, the ----tttt option of _u_n_z_i_p may
  273.                show that some files have a bad CRC. Such files cannot
  274.                be recovered; you can remove them from the archive
  275.                using the ----dddd option of _z_i_p.
  276.  
  277.           ----gggg   Grow (append to) the specified _z_i_p archive, instead of
  278.                creating a new one. If this operation fails, _z_i_p
  279.                attempts to restore the archive to its original state.
  280.                If the restoration fails, the archive might become
  281.                corrupted.
  282.  
  283.           ----hhhh   Display the _z_i_p help information (this also appears if
  284.                _z_i_p is run with no arguments).
  285.  
  286.           ----iiii ffffiiiilllleeeessss
  287.                Include only the specified files, as in:
  288.  
  289.                     zip -r foo . -i \*.c
  290.  
  291.                which will include only the files that end in .c in the
  292.                current directory and its subdirectories. (Note for
  293.                PKZIP users: the equivalent command is
  294.  
  295.                     pkzip -r foo *.c
  296.  
  297.                PKZIP does not allow recursion in directories other
  298.                than the current one.)  The backslash avoids the shell
  299.                filename substitution, so that the name matching is
  300.                performed by _z_i_p at all directory levels.
  301.  
  302.           ----jjjj   Store just the name of a saved file (junk the path),
  303.                and do not store directory names. By default, _z_i_p will
  304.                store the full path (relative to the current path).
  305.  
  306.           ----kkkk   Attempt to convert the names and paths to conform to
  307.                MSDOS, store only the MSDOS attribute (just the user
  308.                write attribute from UNIX), and mark the entry as made
  309.                under MSDOS (even though it was not); for compatibility
  310.                with PKUNZIP under MSDOS which cannot handle certain
  311.                names such as those with two dots.
  312.  
  313.           ----llll   Translate the Unix end-of-line character LF into the
  314.                MSDOS convention CR LF. This option should not be used
  315.                on binary files.  This option can be used on Unix if
  316.                the zip file is intended for PKUNZIP under MSDOS. If
  317.                the input files already contain CR LF, this option adds
  318.                an extra CR. This ensure that _u_n_z_i_p -_a on Unix will get
  319.                back an exact copy of the original file, to undo the
  320.                effect of _z_i_p -_l.
  321.  
  322.           ----llllllll  Translate the MSDOS end-of-line CR LF into Unix LF.
  323.                This option should not be used on binary files.  This
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 12/9/95)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  335.  
  336.  
  337.  
  338.                option can be used on MSDOS if the zip file is intended
  339.                for unzip under Unix.
  340.  
  341.           ----LLLL   Display the _z_i_p license.
  342.  
  343.           ----mmmm   Move the specified files into the _z_i_p archive;
  344.                actually, this deletes the target directories/files
  345.                after making the specified _z_i_p archive. If a directory
  346.                becomes empty after removal of the files, the directory
  347.                is also removed. No deletions are done until _z_i_p has
  348.                created the archive without error.  This is useful for
  349.                conserving disk space, but is potentially dangerous so
  350.                it is recommended to use it in combination with ----TTTT to
  351.                test the archive before removing all input files.
  352.  
  353.           ----nnnn ssssuuuuffffffffiiiixxxxeeeessss
  354.                Do not attempt to compress files named with the given
  355.                _s_u_f_f_i_x_e_s. Such files are simply stored (0% compression)
  356.                in the output zip file, so that _z_i_p doesn't waste its
  357.                time trying to compress them.  The suffixes are
  358.                separated by either colons or semicolons.  For example:
  359.  
  360.                     zip -rn .Z:.zip:.tiff:.gif:.snd  foo foo
  361.  
  362.                will copy everything from _f_o_o into _f_o_o._z_i_p, but will
  363.                store any files that end in ._Z, ._z_i_p, ._t_i_f_f, ._g_i_f, or
  364.                ._s_n_d without trying to compress them (image and sound
  365.                files often have their own specialized compression
  366.                methods).  By default, _z_i_p does not compress files with
  367.                extensions in the list ._Z:._z_i_p:._z_o_o:._a_r_c:._l_z_h:._a_r_j.
  368.                Such files are stored directly in the output archive.
  369.                The environment variable ZIPOPT can be used to change
  370.                the default options. For example under Unix with csh:
  371.  
  372.                     setenv ZIPOPT "-n .gif:.zip"
  373.  
  374.                To attempt compression on all files, use:
  375.  
  376.                     zip -n : foo
  377.  
  378.                The maximum compression option ----9999 also attempts
  379.                compression on all files regardless of extension.
  380.  
  381.           ----oooo   Set the "last modified" time of the _z_i_p archive to the
  382.                latest (oldest) "last modified" time found among the
  383.                entries in the _z_i_p archive.  This can be used without
  384.                any other operations, if desired.  For example:
  385.  
  386.                zip -o foo
  387.  
  388.                will change the last modified time of _f_o_o._z_i_p to the
  389.                latest time of the entries in _f_o_o._z_i_p.
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 12/9/95)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  401.  
  402.  
  403.  
  404.           ----qqqq   Quiet mode; eliminate informational messages and
  405.                comment prompts.  (Useful, for example, in shell
  406.                scripts and background tasks).
  407.  
  408.           ----rrrr   Travel the directory structure recursively; for
  409.                example:
  410.  
  411.                     zip -r foo foo
  412.  
  413.                In this case, all the files and directories in _f_o_o are
  414.                saved in a _z_i_p archive named _f_o_o._z_i_p, including files
  415.                with names starting with ".", since the recursion does
  416.                not use the shell's file-name substitution mechanism.
  417.                If you wish to include only a specific subset of the
  418.                files in directory _f_o_o and its subdirectories, use the
  419.                ----iiii option to the specify the pattern of files to be
  420.                included.  You should not use ----rrrr with the name ".*",
  421.                since that matches ".."  which will attempt to zip up
  422.                the parent directory (probably not what was intended).
  423.  
  424.           ----SSSS   Include system and hidden files. This option is
  425.                effective on some systems only; it is ignored on Unix.
  426.  
  427.           ----tttt mmmmmmmmddddddddyyyyyyyy
  428.                Do not operate on files modified prior to the specified
  429.                date, where _m_m is the month (0-12), _d_d is the day of
  430.                the month (1-31), and _y_y are the last two digits of the
  431.                year.  For example:
  432.  
  433.                     zip -rt 120791 infamy foo
  434.  
  435.                will add all the files in _f_o_o and its subdirectories
  436.                that were last modified on or after 7 December 1991, to
  437.                the _z_i_p archive _i_n_f_a_m_y._z_i_p.
  438.  
  439.           ----TTTT   Test the integrity of the new zip file. If the check
  440.                fails, the old zip file is unchanged and (with the ----mmmm
  441.                option) not input files are removed.
  442.  
  443.           ----uuuu   Replace (update) an existing entry in the _z_i_p archive
  444.                only if it has been modified more recently than the
  445.                version already in the _z_i_p archive.  For example:
  446.  
  447.                     zip -u stuff *
  448.  
  449.                will add any new files in the current directory, and
  450.                update any files which have been modified since the _z_i_p
  451.                archive _s_t_u_f_f._z_i_p was last created/modified (note that
  452.                _z_i_p will not try to pack _s_t_u_f_f._z_i_p into itself when you
  453.                do this).
  454.  
  455.                Note that the ----uuuu option with no arguments acts like the
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 12/9/95)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  467.  
  468.  
  469.  
  470.                ----ffff (freshen) option.
  471.  
  472.           ----vvvv   Verbose mode. Display a progress indicator during
  473.                compression.
  474.  
  475.           ----VVVV   Save VMS file attributes. This option is available on
  476.                VMS only; _z_i_p archives created with this option will
  477.                generally not be usable on other systems.
  478.  
  479.           ----wwww   Append the version number of the files to the name,
  480.                including multiple versions of files.  (VMS only;
  481.                default:  use only the most recent version of a
  482.                specified file).
  483.  
  484.           ----xxxx ffffiiiilllleeeessss
  485.                Explicitly exclude the specified files, as in:
  486.  
  487.                     zip -r foo foo -x \*.o
  488.  
  489.                which will include the contents of _f_o_o in _f_o_o._z_i_p while
  490.                excluding all the files that end in .o.  The backslash
  491.                avoids the shell filename substitution, so that the
  492.                name matching is performed by _z_i_p at all directory
  493.                levels.
  494.  
  495.           ----yyyy   Store symbolic links as such in the _z_i_p archive,
  496.                instead of compressing and storing the file referred to
  497.                by the link (UNIX only).
  498.  
  499.           ----zzzz   Prompt for a multi-line comment for the entire _z_i_p
  500.                archive.  The comment is ended by a line containing
  501.                just a period, or an end of file condition (^D on UNIX,
  502.                ^Z on MSDOS, OS/2, and VAX/VMS).  The comment can be
  503.                taken from a file:
  504.  
  505.                     zip -z foo < foowhat
  506.  
  507.           ----####   Regulate the speed of compression using the specified
  508.                digit #, where ----0000 indicates no compression (store all
  509.                files), ----1111 indicates the fastest compression method
  510.                (less compression) and ----9999 indicates the slowest
  511.                compression method (optimal compression, ignores the
  512.                suffix list). The default compression level is ----6666....
  513.  
  514.           ----@@@@   Take the list of input files from standard input.
  515.  
  516.           ----$$$$   Include the volume label for the the drive holding the
  517.                first file to be compressed.  If you want to include
  518.                only the volume label or to force a specific drive, use
  519.                the drive name as first file name, as in:
  520.  
  521.                     zip -$ foo a: c:bar
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 12/9/95)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  533.  
  534.  
  535.  
  536.                This option is effective on some systems only (MSDOS
  537.                and OS/2); it is ignored on Unix.
  538.  
  539.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  540.           The simplest example:
  541.  
  542.                zip stuff *
  543.  
  544.           creates the archive _s_t_u_f_f._z_i_p (assuming it does not exist)
  545.           and puts all the files in the current directory in it, in
  546.           compressed form (the ._z_i_p suffix is added automatically,
  547.           unless that archive name given contains a dot already; this
  548.           allows the explicit specification of other suffixes).
  549.  
  550.           Because of the way the shell does filename substitution,
  551.           files starting with "." are not included; to include these
  552.           as well:
  553.  
  554.                zip stuff .* *
  555.  
  556.           Even this will not include any subdirectories from the
  557.           current directory.
  558.  
  559.           To zip up an entire directory, the command:
  560.  
  561.                zip -r foo foo
  562.  
  563.           creates the archive _f_o_o._z_i_p, containing all the files and
  564.           directories in the directory _f_o_o that is contained within
  565.           the current directory.
  566.  
  567.           You may want to make a _z_i_p archive that contains the files
  568.           in _f_o_o, without recording the directory name, _f_o_o.  You can
  569.           use the ----jjjj option to leave off the paths, as in:
  570.  
  571.                zip -j foo foo/*
  572.  
  573.           If you are short on disk space, you might not have enough
  574.           room to hold both the original directory and the
  575.           corresponding compressed _z_i_p archive.  In this case, you can
  576.           create the archive in steps using the ----mmmm option.  If _f_o_o
  577.           contains the subdirectories _t_o_m, _d_i_c_k, and _h_a_r_r_y, you can:
  578.  
  579.                zip -rm foo foo/tom
  580.                zip -rm foo foo/dick
  581.                zip -rm foo foo/harry
  582.  
  583.           where the first command creates _f_o_o._z_i_p, and the next two
  584.           add to it.  At the completion of each _z_i_p command, the last
  585.           created archive is deleted, making room for the next _z_i_p
  586.           command to function.
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 12/9/95)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  599.  
  600.  
  601.  
  602.      PPPPAAAATTTTTTTTEEEERRRRNNNN MMMMAAAATTTTCCCCHHHHIIIINNNNGGGG
  603.           This section applies only to UNIX.  Watch this space for
  604.           details on MSDOS and VMS operation.
  605.  
  606.           The UNIX shells (_s_h(1) and _c_s_h(1)) do filename substitution
  607.           on command arguments.  The special characters are:
  608.  
  609.           ????    match any single character
  610.  
  611.           ****    match any number of characters (including none)
  612.  
  613.           [[[[]]]]   match any character in the range indicated within the
  614.                brackets (example: [a-f], [0-9]).
  615.  
  616.           When these characters are encountered (without being escaped
  617.           with a backslash or quotes), the shell will look for files
  618.           relative to the current path that match the pattern, and
  619.           replace the argument with a list of the names that matched.
  620.  
  621.           The _z_i_p program can do the same matching on names that are
  622.           in the _z_i_p archive being modified or, in the case of the ----xxxx
  623.           (exclude) or ----iiii (include) options, on the list of files to
  624.           be operated on, by using backslashes or quotes to tell the
  625.           shell not to do the name expansion.  In general, when _z_i_p
  626.           encounters a name in the list of files to do, it first looks
  627.           for the name in the file system.  If it finds it, it then
  628.           adds it to the list of files to do.  If it does not find it,
  629.           it looks for the name in the _z_i_p archive being modified (if
  630.           it exists), using the pattern matching characters described
  631.           above, if present.  For each match, it will add that name to
  632.           the list of files to be processed, unless this name matches
  633.           one given with the ----xxxx option, or does not match any name
  634.           given with the ----iiii option.
  635.  
  636.           The pattern matching includes the path, and so patterns like
  637.           \*.o match names that end in ".o", no matter what the path
  638.           prefix is.  Note that the backslash must precede every
  639.           special character (i.e. ?*[]), or the entire argument must
  640.           be enclosed in double quotes ("").
  641.  
  642.           In general, use backslash to make _z_i_p do the pattern
  643.           matching with the ----ffff (freshen) and ----dddd (delete) options, and
  644.           sometimes after the ----xxxx (exclude) option when used with an
  645.           appropriate operation (add, ----uuuu, ----ffff, or ----dddd).
  646.  
  647.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  648.           compress(1), shar(1L), tar(1), unzip(1L), gzip(1L)
  649.  
  650.      BBBBUUUUGGGGSSSS
  651.           _z_i_p 2.0.1 is not compatible with PKUNZIP 1.10. Use _z_i_p 1.1
  652.           to produce _z_i_p files which can be extracted by PKUNZIP 1.10.
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 12/9/95)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  665.  
  666.  
  667.  
  668.           _z_i_p files produced by _z_i_p 2.0.1 must not be _u_p_d_a_t_e_d by _z_i_p
  669.           1.1 or PKZIP 1.10, if they contain encrypted members or if
  670.           they have been produced in a pipe or on a non-seekable
  671.           device. The old versions of _z_i_p or PKZIP would create an
  672.           archive with an incorrect format.  The old versions can list
  673.           the contents of the zip file but cannot extract it anyway
  674.           (because of the new compression algorithm).  If you do not
  675.           use encryption and use regular disk files, you do not have
  676.           to care about this problem.
  677.  
  678.           Under VMS, not all of the odd file formats are treated
  679.           properly.  Only stream-LF format _z_i_p files are expected to
  680.           work with _z_i_p.  Others can be converted using Rahul Dhesi's
  681.           BILF program.  This version of _z_i_p handles some of the
  682.           conversion internally.  When using Kermit to transfer zip
  683.           files from Vax to MSDOS, type "set file type block" on the
  684.           Vax.  When transfering from MSDOS to Vax, type "set file
  685.           type fixed" on the Vax.  In both cases, type "set file type
  686.           binary" on MSDOS.
  687.  
  688.           Under VMS, zip hangs for file specification that uses DECnet
  689.           syntax _f_o_o::*.*.
  690.  
  691.           On OS/2, zip cannot match some names, such as those
  692.           including an exclamation mark or a hash sign.  This is a bug
  693.           in OS/2 itself: the 32-bit DosFindFirst/Next don't find such
  694.           names.  Other programs such as GNU tar are also affected by
  695.           this bug.
  696.  
  697.           Under OS/2, the amount of External Attributes displayed by
  698.           DIR is (for compatibility) the amount returned by the 16-bit
  699.           version of DosQueryPathInfo(). Otherwise OS/2 1.3 and 2.0
  700.           would report different EA sizes when DIRing a file.
  701.           However, the structure layout returned by the 32-bit
  702.           DosQueryPathInfo() is a bit different, it uses extra padding
  703.           bytes and link pointers (it's a linked list) to have all
  704.           fields on 4-byte boundaries for portability to future RISC
  705.           OS/2 versions. Therefore the value reported by _z_i_p (which
  706.           uses this 32-bit-mode size) differs from that reported by
  707.           DIR.  _z_i_p stores the 32-bit format for portability, even the
  708.           16-bit MS-C-compiled version running on OS/2 1.3, so even
  709.           this one shows the 32-bit-mode size.
  710.  
  711.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  712.           Copyright (C) 1990-1993 Mark Adler, Richard B. Wales, Jean-
  713.           loup Gailly, Kai Uwe Rommel, Igor Mandrichenko and John
  714.           Bush.  Permission is granted to any individual or
  715.           institution to use, copy, or redistribute this software so
  716.           long as all of the original files are included, that it is
  717.           not sold for profit, and that this copyright notice is
  718.           retained.
  719.  
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 12/9/95)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      ZZZZIIIIPPPP((((1111LLLL))))              IIIInnnnffffoooo----ZZZZIIIIPPPP ((((11118888 SSSSeeeepppptttt 1111999999993333))))              ZZZZIIIIPPPP((((1111LLLL))))
  731.  
  732.  
  733.  
  734.           LIKE ANYTHING ELSE THAT'S FREE, ZIP AND ITS ASSOCIATED
  735.           UTILITIES ARE PROVIDED AS IS AND COME WITH NO WARRANTY OF
  736.           ANY KIND, EITHER EXPRESSED OR IMPLIED. IN NO EVENT WILL THE
  737.           COPYRIGHT HOLDERS BE LIABLE FOR ANY DAMAGES RESULTING FROM
  738.           THE USE OF THIS SOFTWARE.
  739.  
  740.           Please send bug reports and comments by email to:
  741.           _z_i_p-_b_u_g_s@_w_k_u_v_x_1._b_i_t_n_e_t.  For bug reports, please include the
  742.           version of _z_i_p, the make options used to compile it, the
  743.           machine and operating system in use, and as much additional
  744.           information as possible.
  745.  
  746.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  747.           Thanks to R. P. Byrne for his _S_h_r_i_n_k._P_a_s program, which
  748.           inspired this project, and from which the shrink algorithm
  749.           was stolen; to Phil Katz for placing in the public domain
  750.           the _z_i_p file format, compression format, and .ZIP filename
  751.           extension, and for accepting minor changes to the file
  752.           format; to Steve Burg for clarifications on the deflate
  753.           format; to Haruhiko Okumura and Leonid Broukhis for
  754.           providing some useful ideas for the compression algorithm;
  755.           to Keith Petersen, Rich Wales, Hunter Goatley and Mark Adler
  756.           for providing a mailing list and _f_t_p site for the INFO-ZIP
  757.           group to use; and most importantly, to the INFO-ZIP group
  758.           itself (listed in the file _i_n_f_o_z_i_p._w_h_o) without whose
  759.           tireless testing and bug-fixing efforts a portable _z_i_p would
  760.           not have been possible.  Finally we should thank (blame) the
  761.           first INFO-ZIP moderator, David Kirschbaum, for getting us
  762.           into this mess in the first place.  The manual page was
  763.           rewritten for UNIX by R. P. C. Rodgers.
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 12/9/95)
  790.  
  791.  
  792.  
  793.